3T, Simple File Manager for Psion Series 3a. CONTACT: Written by Roger Muggleton Email: hzk@cix.compulink.co.uk CompuServe: 100764,1716 Packet Radio: G0HZK@GB7WIR.#42.GBR.EU Mail Address: 23 Randolph Road, Langley, Slough, SL3 7QF, United Kingdom. OVERVIEW: 3T is a smallish application which handles most normal day-to-day file activities. It can view, copy, move, and delete files, make new directories and remove unwanted ones. It works on single files, or groups of tagged files. Up to 39 or 70 files can be displayed at once, although directories containing up to 200 files can be worked with. 3T is not as clever as some file managers, but it should be quicker than most. REGISTRATION: 3T is a free program which may be copied and used without charge. If you pass this program on to someone else, please give them a copy of the original archive. However, I am always pleased to hear from any user, so if you find my program useful, an Email or postcard would be appreciated! USAGE: Copy 3T.OPA to an \APP\ directory on any drive. Install in the usual way, using Psion-I from the system screen. Run 3T by highlighting the word "ThreeT" underneath 3T's icon, and press enter. The display shows 3 windows. The top window shows the full name, path and size of the file (or directory) highlighted in the lower window. The status window shows the media type (ROM, RAM, Flash), the space used in kbytes, and the space free. The lower window shows up to 39 or 70 files in the current directory. (The screen resolution is changed using Psion-Z). As you press the arrow keys, each item is highlighted in turn. If you move past the last displayed file, the window does NOT scroll, but the next file name will be shown in the top window. You can view up to 200 files this way. The display is sorted, with directory names first. THE KEYS: 0-9, A-z By pressing one of these keys without the Psion modifier key, you can hop around the lower window. For example, repeated pressing of 'B' will jump between all the files/directories that begin with the letter B. The following can be pressed for actions on highlighted files. Psion-C Copy a file. A dialog appears, enabling you to choose a new drive and/or directory to copy the file to. You can select only existing directories. You can change the destination name if required (on single file operation only). If the destination name exists, you can overwrite, rename, or abort the action. Psion-D Delete a file or directory. A dialog asking for confirmation appears. If you delete a directory containing files, any files and subdirectories within are also deleted. (The 'delete' key can also be used). Psion-E Execute a ROM application. The highlighted file will be loaded into the appropriate ROM application - Word, Data, Sheet, OPL Editor, Text Editor, or RunOpl. If 3T does not recognise the file type, a menu will appear so that you can select one of the five applications. Psion-M Move a file. Files can be moved from one location to another. If any files are not copied for some reason, those files will not be deleted. Psion-R Rename a file. This renames a file. You cannot move its directory by renaming - use the Psion-M key if this is desired. If your new name has no extension (.OPL etc.), add a dot after the last letter of the new name. If you wish to keep the same extension as the original name, you need only type the letters before the dot, and the dot and extension will be added automatically. Psion-T Tag a file. This tags files for actions on groups of files. The C, D and M commands detect when files have been tagged. When all files have been 'actioned', the tags are cleared. Tagged files are shown in italics. The plus (+) key also tags files. Psion-U Untag a file. Removes a 'tag' from a file. The minus (-) key will also untag files. Psion-V Views a file. This is a limited facility which dumps files to the main window. You can scroll down the file by pressing DownArrow. Any other key returns to the file list. If the file ends .ASC, .CAP, .DOC, .TXT or .OPL, then the file is shown in non-wordwrapped ascii text format. Otherwise it is wrapped at the border, and displayed as an ascii dump. Psion + Makes a new directory. This works only when a directory is highlighted. If the name typed in is preceded by a backslash, it is placed in the root, otherwise it is placed in the highlighted directory. (The full path is displayed before the new directory is created - you can abort here!) Enter i) Shows file size, date, attributes. By pressing Enter at the dialog, file attributes may be altered. ii) Moves to the highlighted directory. iii) If '' is highlighted, moves to parent directory. Other keys: Psion-I Version, and how to contact the author by Email. Psion-L Log a new drive. Carry out action on a different drive. Initially the contents of the 'default' drive are displayed. See Psion-P for PC drives. Psion-P Log a PC drive. If linked to a PC in the usual way, all PC drives present will be available. This has been tested only on an IBM type PC, but it may work with other computers. Psion-S Toggles a check of whether filenames without extensions are directories. By default, all such names are checked. By turning this check off, file display is slightly faster. This also means that 3T will assume a file called FRED is a directory, and add a [dir] after it. However, if you try any action on FRED, it will check its status first, and then treat FRED correctly as a file. Psion-W The directory check status and the zoom setting are stored in an environment variable called RM3T. It you wish to remove 3T from your Psion, Do a Psion-W before a Psion-X (exit) which will remove this variable from the environment. Psion-X Exits from 3T. Psion-Z Toggles 39 file and 70 file displays. Escape Moves to parent of current directory. Menu Guess what! LIMITATIONS: 3T cannot handle directories more than 9 layers deep! You can view only up to 39 or 70 files on the screen. While 3T does not scroll if there are more, their names will appear in the top window, and all actions still work on them. Up to 200 files can be handled. If your directory contains more, these extra files will not be accessible. The date is shown in U.K. format, i.e. dd-mm-yy. (I can easily change this if required). The Psion-P command will allow you to read directories on a PC linked to your Psion. The Psion should be linked in the normal way, using a PC program like SLINK, RCOM, or PSIWIN. If you use PSIWIN, remove the switch /X from the line: ENGINE=PRCENWIN.EXE in the file \WINDOWS\PSIONPRC.INI Note that this is very slow! It seems quicker with RCOM though! 3T assumes that all directories do not have extensions, e.g. FRED, but not FRED.DIR, is a directory. If you do have a directory FRED.DIR, it will not be displayed with a [dir], but otherwise should work correctly. When 3T reads a file without an extension, it then checks whether it is a directory. This can be disabled with Psion-S, which leads to a faster display. Thus the "Fast Display" message when you run 3T will signify that directory checking is disabled. A file wrongly shown as a directory in this case will still act like a file if you copy or delete it, etc., Psion-S only affects how it is displayed. Psion-S is a toggle, so you can turn checking on and off at will. (I hope you can understand this waffle!!) Most errors have been trapped (I think), but there is bound to be some case where I goofed. THANKS are due to: Max Bisschop for the file sort and display routine, David Palmer for his idea for a directory "prune" routine. WARNING: 3T has the ability to delete data. Please make sure you delete only the files and directories you intent to! I disclaim any responsibility for any data loss, damage, or any unwanted effects whatsoever. Roger Muggleton. hzk@cix.compulink.co.uk -------------------------------------------------------------------------- RELEASE DETAILS for Version 1.32 September 5th, 1996 New in 1.32: Bug fixes. There was a programming error which caused a crash in some Psion models when Psion-S was pressed. Not in mine of course :-( so apologies to all those who suffered this bug. It should not happen in this version I hope. Both the Psion-S and -Z settings are now stored on exit. Changes since 1.30: When a directory is deleted, all the files and nested subdirectories inside it will also be deleted. If a file is open, or the Read Only attribute is set, the delete action will abort with a suitable message. This version now displays files as a sorted list, with directories first. Alas, it is almost 2k bigger, but it is much faster. The code to achieve this was written by Max Bisschop, to whom I am most grateful. Max also sped up the display by using an arbitrary method of deciding whether a file was a directory. I used a faster way of confirming this, and the Psion-S command switches this extra check out and in. Pressing Enter on a file name brings up the file info dialog as before. You can clear this with Esc, or by pressing Enter again, you get the chance to change file attributes. This new dialog displays the current attributes, so pressing Enter alone will not change them, and you can press Esc here to avoid re-writing the attributes. Launching an open file/applicaion (Psion-E) will bring it to the front, instead of generating an error. You can return to 3T with Shift-System. If you try to view an open file, you now get an alert (instead of a crash). The file "View" window (Psion-V) is now full screen width. The used disk and free disk space is now in kbytes. Changes since Version 1.25: The Application Name has been changed to "ThreeT". This is to avoid conflict with other file managers. Unfortunately you can't have an application name beginning with a number! So please remember to deinstall the old version (Psion-/), and reinstall this version (Psion-I). If you run 3T from a macro, you will have to change this too! 3T now has a menu! But to make room, I have removed the 'HELP' screen. But all the commands are visible from the menu anyway. You can now tag files with the plus (+) key, and untag with the minus (-) key, like the Psion file selector. Psion-T and Psion-U still work as well. File launching is more specific. TXT files are now loaded into the text editor, and there is a text editor option for files with unrecognised extensions. The cursor position is now stored as you move through a directory tree. So as you move back towards the root, the cursor will restore to the original position in each layer. Also when a file is renamed, moved, or deleted, the cursor will move to an appropriate position. The position should also be retained if you change resolution. --------------------------------------------------------------------------